home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d4 / larn12a.arc / LARN.DOC next >
Text File  |  1986-11-05  |  16KB  |  463 lines
  1.                                                            PC LARN v12.0
  2.  
  3.  
  4.  
  5.                  PC LARN version 12.0 for MSDOS(tm) computers
  6.                  --------------------------------------------
  7.  
  8.                              by Don Kneller
  9.                                 2 Panoramic Way #204
  10.                                 Berkeley, CA 94704
  11.                                 October 20, 1986
  12.  
  13.  
  14.   Table of contents
  15.   -----------------
  16.  
  17.        
  18.  
  19.   Introduction....................................................2
  20.   System requirements.............................................2
  21.   Configuration...................................................3
  22.   Command line options............................................5
  23.   TERMCAP.........................................................6
  24.   WIZARD mode.....................................................7
  25.        
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                                            PC LARN v12.0
  68.  
  69.  
  70.   Introduction
  71.   ------------
  72.  
  73.        LARN is a dungeon type adventure game similar in concept to ROGUE or
  74.   HACK but with a much different feel.  LARN is copyrighted 1986 by Noah
  75.   Morgan (USENET: panda!condor!noah) at GenRad Inc. Bolton MA.  This version
  76.   is a port of his game into the MSDOS environment by Don Kneller.
  77.  
  78.  
  79.   System requirements
  80.   -------------------
  81.  
  82.        PC LARN requires:
  83.  
  84.        - MSDOS or PCDOS 2.x or above.
  85.  
  86.        - at least 256K of RAM.
  87.  
  88.        - disk storage capacity of at least 360K, although twice that much is
  89.          preferred if you want to "checkpoint" your game to prevent
  90.          accidental lose due to a system failure.
  91.  
  92.        - the ANSI.SYS device driver must be installed (although the NANSI.SYS
  93.          driver is *strongly* preferred and has been included in this
  94.          distribution).  You should install either ANSI.SYS or NANSI.SYS, but
  95.          not both.  To install NANSI.SYS, put the line "device=NANSI.SYS" in
  96.          your CONFIG.SYS file.  See the TERMCAP section for further details.
  97.  
  98.  
  99.   Files supplied
  100.   --------------
  101.  
  102.        The following files should be include in this LARN12.ARC file:
  103.  
  104.        LARN.DOC
  105.             This documentation
  106.  
  107.        LARN.EXE
  108.             The executable file.
  109.  
  110.        LARN.FTN
  111.             Fortune cookie messages.
  112.  
  113.        LARN.HLP
  114.             A help file which can be read with the "?" command in LARN.
  115.  
  116.        LARN.MAZ
  117.             Some maze levels are precalculated and stored here.
  118.  
  119.        NANSI.DOC
  120.             The documentation for:
  121.  
  122.        NANSI.SYS
  123.             A new ANSI.SYS that is *much* faster than ANSI.SYS and supports
  124.             the line insert and line delete escape sequence that LARN uses.
  125.             This excellent product is written by Daniel Kegel.  See the
  126.             TERMCAP section and NANSI.DOC for more details.
  127.  
  128.        TERMCAP
  129.             A file describing the escape sequences to send to the terminal to
  130.  
  131.  
  132.  
  133.                                                            PC LARN v12.0
  134.  
  135.  
  136.             change video modes.  The supplied TERMCAP file is for monochrome
  137.             systems.  See the TERMCAP section for details on changing
  138.             TERMCAP.
  139.  
  140.  
  141.   Configuration
  142.   -------------
  143.  
  144.        PC LARN is configured to your system by options placed in the file
  145.   LARN.OPT.  When PC LARN starts up, it looks in the current directory for
  146.   this file, then in directories along your PATH.  This is the same behavior
  147.   DOS uses when trying to find executable files.  For a hard disk system I
  148.   suggest creating a \GAMES directory and putting LARN.EXE, LARN.OPT and
  149.   TERMCAP in there, then put \GAMES on your PATH.  For a 2-floppy system, put
  150.   COMMAND.COM on new disk and put these 3 files on this disk.
  151.  
  152.        Now create a LARN directory and put the included files LARN.FTN,
  153.   LARN.MAZ, and LARN.HLP in there.  LARN will create other files in this
  154.   directory, including the score file (LARN.SCR), a file to identify the
  155.   person playing (LARN.PID) and a file listing all the people who have played
  156.   to date (LARN.LOG).  Also, save games (LARN.SAV) and checkpoint games
  157.   (LARN.CKP) will go in here.
  158.  
  159.        For systems with hard disks, create the subdirectory "LARN" in the
  160.   \GAMES directory.  Your "larndir" is now "\GAMES\LARN".  For 2-floppy
  161.   systems you can have "larndir" as "A:", but you will have to save games on
  162.   another drive (see "savefile" option below).
  163.  
  164.        Here are the options that can be put in LARN.OPT.  Options that are
  165.   followed with a colon, ":", take at least one argument.  Options without a
  166.   colon are boolean, meaning you select that option merely by mentioning it.
  167.  
  168.  
  169.   These options are only in PC LARN:
  170.  
  171.        larndir:       directory
  172.             Sets "directory" to be the place LARN looks for files.  For hard
  173.             disks set this to be \GAMES\LARN.  For 2-floppy systems, use A:
  174.             
  175.             If "larndir" is not specified, the current directory is assumed.
  176.  
  177.        ramlevels:     number
  178.             This number is the maximum number of levels PC LARN will keep in
  179.             memory.  The number can be between 1 and 14.  Normally, PC LARN
  180.             will use as much memory as available, but you may want to use
  181.             less so there will be enough memory to start up a second copy of
  182.             COMMAND.COM with the LARN command `!'.  If there isn't enough
  183.             memory for COMMAND.COM, LARN will clear the screen and prompt
  184.             with "A>" until return is struck, then go back to the game.
  185.             
  186.             If "ramlevels" is not specified, a value of 14 is used.  If
  187.             "number" is less than 14, LARN will use a swapfile to store the
  188.             oldest levels.  Note that a level takes about 8K of memory.
  189.  
  190.        swapfile:      filename
  191.             This is the name of the swap file that will be used if ramlevels
  192.             is less than 14.  If all the levels fit in memory, no swap file
  193.             will be used.  You may want to put the swapfile on a RAMdisk.
  194.             
  195.  
  196.  
  197.  
  198.  
  199.                                                            PC LARN v12.0
  200.  
  201.  
  202.             If "swapfile" is not specified, LARN.SWP in directory larndir
  203.             will be used.
  204.  
  205.        graphics:      wallc     floorc
  206.             In UNIX LARN, the wall character is a # and the floor character
  207.             is a blank (which makes it almost impossible to tell where you've
  208.             been).  In PC LARN, the default wall character is also a # but
  209.             the default floor character is a period.
  210.             
  211.             This option allows you to change these characters to something
  212.             you like.  I use 176 (a graphic block) and 249 (a central dot).
  213.             Since almost all normal ASCII characters are used for something
  214.             already, you should only choose numbers that are in the graphics
  215.             character set (ie those with decimal values greater than 128).
  216.  
  217.        keypad
  218.             This enables the keypad for use with LARN.  A *BIOS* call is used
  219.             to read the keypad.  The correspondance between keypad and game
  220.             command is:
  221.             
  222.                    Keypad                   Command
  223.                    7  8  9         u+l(y)    up(k)    u+r(u)
  224.                     \ | /                 \    |    /
  225.                    4 -5- 6        left(h)   nothing   right(l)
  226.                     / | \                 /    |    \
  227.                    1  2  3         d+l(b)    down(j)  d+r(n)
  228.                  Ins             inventory(i)
  229.             
  230.             The letter in () is the game command letter. "u+l" means up and
  231.             left.  The keypad "7" is translated to the command for moving one
  232.             space up and left.  With shift the commands are the same as the
  233.             uppercase letters.
  234.  
  235.        cursor:        start-line     end-line
  236.             Normally, LARN uses the standard DOS cursor (the flashing
  237.             underscore) to show where your player is located.  This can be
  238.             difficult to see.  This option results in a *BIOS* call to change
  239.             the cursor size.  For a monochrome display, the normal value of
  240.             start-line and end-line is 11 and 12.  Values of 4 and 9 give a
  241.             larger cursor which is not too obtrusive.
  242.             
  243.             If "cursor" is not specified, no BIOS call is made.
  244.  
  245.        rawio
  246.             This option causes the input and output of your computer to be
  247.             switched to "raw" mode.  The advantage of this is faster output
  248.             and better handling of special characters ^S and ^P.
  249.             
  250.             ===========  WARNING ==========
  251.             Some computers (eg. DEC Rainbows) hang if rawio is attempted.
  252.             ==============================
  253.  
  254.        DECRainbow
  255.             Put this in LARN.OPT if your computer is a DEC Rainbow and you
  256.             want to use graphics characters for drawing the maze.  You can
  257.             use any characters from the ASCII character set and from the
  258.             "line-drawing" character set.  To use line-drawing characters,
  259.             take the decimal value of the character and add 128 to it.  This
  260.             makes the values of line-drawing characters lie between decimal
  261.             128 and 255 and tells PC LARN you want a line-drawing character.
  262.  
  263.  
  264.  
  265.                                                            PC LARN v12.0
  266.  
  267.  
  268.   The following are options found in UNIX LARN as well:
  269.  
  270.        enable-checkpointing
  271.             With this option, the game is saved every 400 moves.  If your
  272.             system crashes it is possible to recover from the last checkpoint
  273.             file (LARN.CKP in the LARN directory) with the command "larn ++".
  274.  
  275.        monster:       name
  276.             Sets the name of a monster.  If the name has a space in it,
  277.             enclose it in double quotes (eg "tooth fairy").
  278.  
  279.        name:          yourname
  280.             Sets the name of the player.  If you want a space in your name,
  281.             enclose it in double quotes (eg "Mad Max").
  282.  
  283.        no-introduction
  284.             Skip displaying the opening messages.
  285.  
  286.        no-beep
  287.             Disable sound from the speaker.
  288.  
  289.        savefile:      filename
  290.             The filename to use for saving the game.  The default is LARN.SAV
  291.             in the LARN directory.  For a 2-floppy system you should use
  292.             B:LARN.SAV if the LARN directory is on the A disk drive.
  293.  
  294.  
  295.   Command line options
  296.   --------------------
  297.  
  298.        There are several command line options that can modify the behavior of
  299.   LARN.  These are:
  300.  
  301.        -o optionfile  Use this as the option file rather than LARN.OPT.  As
  302.                       with LARN.OPT, the current directory then directories
  303.                       along your path are searched for this file which
  304.                       supplies configuration information.
  305.  
  306.        -s             Show scores.
  307.  
  308.        -l             Show log file.
  309.  
  310.        -i             Show all scores including inventories.
  311.  
  312.        -c             Create a new score file.  You have to know the Wizard's
  313.                       password to do this.  Erasing LARN.SCR has the same
  314.                       effect.
  315.  
  316.        -n             No welcoming message.  Prevents printing of the short
  317.                       introduction to LARN.  Putting the "no-introduction"
  318.                       configuration option in LARN.OPT has the same effect.
  319.  
  320.        -#             Where # is a number from 0 to 9.  This sets the
  321.                       difficulty of LARN to this level.  Normally, LARN
  322.                       starts out with difficulty 0 and increases in
  323.                       difficulty by 1 when you win at the current level.
  324.                       Thus the game automatically gets more difficult.
  325.  
  326.        -h             A help screen that shows the command line arguments.
  327.  
  328.  
  329.  
  330.  
  331.                                                            PC LARN v12.0
  332.  
  333.  
  334.        ++             Restore a game from a checkpoint file.  If you have
  335.                       checkpointing enabled (with the "enable-checkpointing"
  336.                       configuration option in LARN.OPT) then LARN writes a
  337.                       checkpoint file every 400 moves.  Should your system
  338.                       crash you can recover the game from the checkpoint file
  339.                       with this command line option
  340.  
  341.        For example:  "larn -n -o bobslarn.opt" starts up LARN with no
  342.   introductory message and uses bobslarn.opt file for configuration options.
  343.   "larn ++" tries to restore LARN from a checkpoint file.
  344.  
  345.  
  346.   TERMCAP
  347.   -------
  348.  
  349.        LARN uses the UNIX "termcap" to select escape sequences to be sent to
  350.   the terminal driver (either ANSI.SYS or NANSI.SYS) to change video modes.
  351.   When LARN starts up, it checks in the environment for the variable called
  352.   "TERM".  The DOS command:
  353.        set TERM=ibmpc-ega
  354.   will give the environment variable "TERM" the value "ibmpc-ega".  By
  355.   default, LARN assumes the value of TERM is "ibmpc-mono".
  356.  
  357.        Then LARN looks in the file called "TERMCAP" for a terminal definition
  358.   with the same name as the value of TERM.  LARN first looks for TERMCAP in
  359.   the current directory, then in directory "\ETC" (the normal UNIX place),
  360.   then in directories along your PATH.
  361.  
  362.        The TERMCAP file uses 2 letter codes to describe each escape sequence
  363.   and \E to mean ESC (the escape character is decimal 27).  Each entry is
  364.   enclosed in colons.  For example, to start underscore mode on a monochrome
  365.   display, we want to send the sequence "ESC[4m".  This looks like
  366.   ":us=\E4m:" as a termcap entry.
  367.  
  368.        The following sequences are used by LARN:
  369.  
  370.        ti   terminal initialization.  You could have something like:
  371.                  :ti=\E44;37m:
  372.             which would mean to select blue background and white foreground.
  373.  
  374.        te   terminal end.  To reset your terminal to white on black:
  375.                  :te=\E0m:
  376.  
  377.        so   stand out.  Select red foreground, keeping the blue background:
  378.                  :so=\E31m:
  379.  
  380.        se   standout end.  Back to white on blue:
  381.                  :se=\E44;37m:
  382.  
  383.        al   insert line.  This is *not* available in ANSI.SYS, so remove this
  384.             entry if you're using ANSI.
  385.  
  386.        dl   delete line.  This is *not* available in ANSI.SYS, so remove this
  387.             entry if you're using ANSI.
  388.  
  389.        If you want to make your own TERMCAP entry, copy the "ibmpc-mono"
  390.   entry, replace the name (eg use "ibmpc-color" or "ibmpc-ega" or whatever),
  391.   then replace the sequences with whatever you please.  The possible escape
  392.   sequences are listed in Chapter 13 of the DOS 2.0 manual.  I don't know
  393.   where they are for DOS 3.1 since they aren't in the DOS manual.  The
  394.  
  395.  
  396.  
  397.                                                            PC LARN v12.0
  398.  
  399.  
  400.   NANSI.DOC file has a table of character attributes that you can use with
  401.   NANSI.SYS.  They are the same as used by ANSI.SYS.
  402.  
  403.        Remember to change the environment variable "TERM" to reflect which
  404.   TERMCAP entry you want!  You should probably put a "set TERM=..." line in
  405.   your AUTOEXEC.BAT file.
  406.  
  407.  
  408.   WIZARD mode
  409.   -----------
  410.  
  411.        There is a WIZARD mode for testing features of the game.  To get into
  412.   WIZARD mode, type in an underscore "_" and answer the prompt for the
  413.   password with "pvnert(x)".  Wizards are non-scoring characters that get
  414.   enlightenment, everlasting expanded awareness and one of every object in
  415.   the game.
  416.  
  417.        
  418.  
  419.        
  420.  
  421.        
  422.  
  423.        
  424.  
  425.        
  426.  
  427.        I hope you enjoy this version of LARN.  Please refer any inquires on
  428.   this MSDOS implementation to:
  429.  
  430.                  D. G. Kneller
  431.                  2 Panoramic Way #204
  432.                  Berkeley, CA 94704
  433.                  UUCP:     ...ucbvax!ucsfcgl!kneller
  434.                  ARPA:     kneller@cgl.ucsf.edu
  435.                  BITNET:   kneller@ucsfcgl.bitnet
  436.  
  437.        
  438.  
  439.  
  440.  
  441.  
  442.  
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.  
  460.  
  461.  
  462.  
  463.